Inicio rápido

Instala las herramientas necesarias

Descarga e instala OpenXava (si todavía no lo has hecho):

• Ve a http://www.openxava.org/downloads
• Descarga la última distribución. Es un archivo zip.
• Descomprime el archivo en tu ordenador.

Descarga e instala el JDK (si no lo tienes instalado):

• Ve a http://www.oracle.com/technetwork/java/javase/downloads/index.html
• Descarga el último JDK. OpenXava funciona con Java 8, 7 y 6. (No uses Java 9 o 10)
• Instálalo. Recuerda donde lo instalas porque lo necesitarás para configurar el Tomcat en la siguiente sección

Descarga e instala Eclipse (si no lo tienes instalado):

• Ve a http://www.eclipse.org/downloads/eclipse-packages
• Descarga 'Eclipse IDE for Java EE Developers'.
• Instálalo.

Configura Tomcat

Has de indicar al Tomcat donde has instalado el JDK.
Con Windows, añade la siguiente línea al principio de catalina.bat en la carpeta tomcat\bin:

set JAVA_HOME=C:\Program Files\Java\jdk1.8.0_45

No pongas C:\Program Files\Java\jdk1.8.0_45 pon la ruta en donde está instalado el JDK en tu sistema.
Con Linux o Mac, añade la siguiente línea al principio de catalina.sh en el directorio tomcat/bin:

export JAVA_HOME=/usr/lib/jvm/java-8-openjdk

No pongas /usr/lib/jvm/java-8-openjdk pon la ruta en donde está instalado el JDK en tu sistema.

Arranca Tomcat

Arranca el Tomcat, con Windows simplemente haz doble click en startup.bat de tomcat\bin:

Si usas Linux o Mac ejecuta el startup.sh que se encuentra la carpeta tomcat/bin de OpenXava:

Arranca Eclipse

Arranca Eclipse, te preguntará que escojas el workspace, escoge el que viene incluido con OpenXava:

Si ya tenías el Eclipse arrancado usa la opción File >Switch Workspace. Si estás usando una versión antigua de Eclipse te preguntará "Workspace ... was written with a newer version of the product and can be incompatible with this version. If you continue, this can cause unexpected behavior or data loss", no te preocupes, pulsa en OK.

Ejecuta la aplicación de ejemplo

La distribución de OpenXava viene con una aplicación de ejemplo llamada MySchool, para ejecutarla sigue los siguientes pasos.
Construye y despliega el proyecto:

Ve a http://localhost:8080/MySchool/modules/Teacher usando tu navegador para ver la aplicación en acción:

Añade otra clase

Añade una clase nueva al proyecto MySchool:

Después teclea Pupil para la clase:

Copia el código siguiente en tu clase Pupil:

package org.openxava.school.model;
 
import javax.persistence.*;
import org.openxava.annotations.*;
 
@Entity
public class Pupil {
 
    @Id @Column(length=2) @Required
    private int number;
 
    @Column(length=40) @Required
    private String name;
 
    public int getNumber() {
        return number;
    }
 
    public void setNumber(int number) {
        this.number = number;
    }
 
    public String getName() {
        return name;
    }
 
    public void setName(String name) {
        this.name = name;
    }
 
}

Ahora podemos desplegar la aplicación:

Ve a http://localhost:8080/MySchool/modules/Pupil para ver Pupil funcionando (si pide identificación usa usuario: admin, contraseña: admin):

Añade una referencia a profesor en alumno

Es fácil hacer que un alumno tenga una referencia a un profesor. Añade el siguiente código a la clase Pupil:

@Entity
public class Pupil {
 
    ...
 
    // INICIO CÓDIGO A AÑADIR
    @ManyToOne
    private Teacher teacher;
 
    public Teacher getTeacher() {
        return teacher;
    }
 
    public void setTeacher(Teacher teacher) {
        this.teacher = teacher;
    }
    // FIN CÓDIGO A AÑADIR
 
}

Despliégalo:

Ve a http://localhost:8080/MySchool/modules/Pupil y selecciona el modo detalle:

Visualiza referencia a profesor con un combo

Si queremos que la referencia se visualice en formato combo hemos de añadir la anotación @DescriptionsList a la referencia teacher de Pupil, como sigue:

@Entity
public class Pupil {
 
    ...
 
    @DescriptionsList  // AÑADE ESTO
    @ManyToOne
    private Teacher teacher;
 
    ...
 
}

Ahora despliega de nuevo:

Ve a http://localhost:8080/MySchool/modules/Pupil:

Añade una colección de alumnos en profesor

Añadamos una colección de alumnos a profesor. Para eso pon la declaración de la colección dentro de la clase Teacher:

@Entity
public class Teacher {
 
    ...
 
    // INICIO CÓDIGO A AÑADIR
    @OneToMany(mappedBy="teacher")
    private Collection<Pupil> pupils;
 
    public Collection <Pupil> getPupils() {
        return pupils;
    }
 
    public void setPupils(Collection <Pupil> pupils) {
        this.pupils = pupils;
    }
    // FIN CÓDIGO A AÑADIR
 
}

Y despliégalo otra vez:

Ve a http://localhost:8080/MySchool/modules/Teacher:

Crea tu propio proyecto

¡Bien hecho! Has ejecutado y modificado un proyecto ya existente. Ahora deberías crear tu propio proyecto OpenXava desde cero:

Sigue la lección: Primeros pasos

¿Algún problema con esta guía? Pregunta en el foro de ayuda.